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AppleWorks makes plain and dear the computer's potential as a personal 
tool. And it elucidates the potential hidden within the "aged technology" of 
theApple II. ^picWbrfcs is also today'sbcst-selling Apple II program. !t sells 
so well in fact that it has become as importanta characteristic of the Apple II 
as DOS, Applesoft, or the Monitor. It doesn't need to be italicized anymore. 

1 suspect that AppleWorks has snuck up on many of you old-timers; I 
suspect many of you aren't ready to accept it as one of the defining 
characteristics of the Apple II. But look at today's first-time Apple buyers. 
They are investing their learning time in AppleWorks rather than in Applesoft 
and DOS. Look at user group newsletters— there has been a subtle shift in 
their content during the last 18 months away fix)m mat^al on Basic 
programming and toward material on AppleWorks programming. 

Releasing the full potential of the Apple II in 1985 requires acpertise in 
both areas. Just as Applesoft allows you to do things that you'd never 
accomplish in assembly language, AppleWorks allows you to do things that 
you'd never accomplish in Basic— writing the program would simpty take 
too long. On the ottier hand just as assembly language routines can add 
speed and flexiblity to Applesoft programs, Applesoft routines can add 
speed and flexibility to the manipulation of data stored in AppleWorks files. 
Tliis month we're going to start examining AppleWorks in detail. 

^pleWorks on the II-PIus. Before all you II-Plus and franklin users get 
mad and fire off' angry letters to me, here's some good news for you. If you 
already have an 80-coIumn card and you can get a program that will 
modify AppleWorks to run on your machine for as little as $19.95. The 
program is called Hus-mtrks and if s available firom Norwich Data Services, 
P.O. Box 356, East Morwich, n.Y. U732 (516-922-9584). 

The program comes in three versions. The basic $19.95 version allows a 
lOK desktop. It provides fo( using escape as the open-apple key, for using 
control keys for the up and down arrows and delete key, and works with 
Vtdex<ompatibIe dOcolumn cards (essentially all major cards except the 
Smarterm, Wzard, and Super-R-Term). 

The other two versions are Fius-Works XM and Plus-Works XM-E These 
versions cost $49.95 and provide all the features of the basic version, plus 
have the ability to increase the AppleWorks desktop size witii standard- 
peripheral-slot memory boards (Legend and Saturn cards and the equivalent 
—but not Applied Engineering's RAMworks, which is an awdllary slot 
memory board). Even He owners may be interested in Fius-Works if they 
already have one of these boards. Unlike the RAMworks expansion software, 
Plus-Works puts the entire available memoiy into the desktop— there is no 
loss due to overhead. Like RAMworks, (and unlike a similar program Wdex is 
selling) Plus-Works modifies an image of AppleWorks, v^^ich can then be 
copied onto backup floppies or to a hard disk. However, Plus-Works does not 
yet provide any of the exba features of the RAMwori^ expander, such as file 
segmentation or inaeasing the maximum number of data base records. 



The difference between theXM and XM-P versions is that the latter can also 
use the 64K of memory on a PCPI CP/M card, franklin 1200 computers came 
with these cards as standard equipment, so this version was developed 
primarily for Franklins, but it works on Apples with the PCP! card as well. 

1 have not tested Plus-Worksmyse\l butwas made aware of it by a call from 
an enthusiastic Open-^pp/e subscriberw^o has. I've talked to the people at 
riorwich Data Systems on the phone, and I think they potentially have a hot 
product here. It makes AppleWorks available on the entire Apple II family. 

At the top of ttie next page is a set of six AppleWorks saeen images. The 
two on the left: are from the word processor, the two in the center firom the 
data base program, and the two on the right ii-om the spreadsheet These are 
the three mqjor programs within ApplelAtorks. 

The word procemi; The AppleWorks word processor provides standard 
fiill-sareen editing. You move Ae cursor around the saeen with the Apple's 
arrow keys. All of AppleWorks, including the word processor, supports two 
cursors. One, the "insert cursor," always pushes any existing text ahead of it 
as new characters are entered. It looks like a blinking underiine. The second 
cursor is called the "overstrike cursor." It is a blinking box. With it, whatever 
you type replaces the character at that position. However, existing canriage 
returns are not overwrittoi but pushed to the ri^t so even this cursor will 
insert text in the right situation. At any point within AppleWforks you can 
switch between the two cursors by pressing open-apple-E. 

Print formatting— adjusting margins, choosing type size and st^e, 
dioosing line spacing and justification— is done throughout AppleWorks 
with the open-appleO ccmimand. In the word processor, this command 
overiays a menu on the tower half of the screen, u^idi shows all the 
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formatting options. IMdlMe and undetUrOng can be turned cm and off 
either by means of this menu, or directly with control-B and contarol-L (Por 
example, the first use of control-B within a paragraph turns bold on, the 
second turns it off. AppleWorks automatically turns off bold and underlining 
at the end of each paragraph.) The only other control-code supported by 
AppleWorks is control-Y, which deletes all mateiial from the cursor position 
to the end of the line. 

Some print formatting instructions, such as margin adjustments and 
centering, affect the saeen display as well as printed output One nice 
feature is that the open-apple-K command will calculate and display the 
position of all page breaks (in the spreadsheet open-apple-K forces 
recalculation). 

Each of the three AppleWorks programs has two display formats. The 
standard formats are shown in the three images on the top of this page. The 
secondary formats are shown in the three images just under the top three. 
When using AppleWorks, you can toggle or switch between the two available 
<]^5play formats 1^ pressir^ op^i-apple-Z(oom). 

In the iffml psooesm ti^ secxmd display shows embedded fiMiiiatting 
information. At the top of this page, the second word proossor display 
shows formatting information relating to the number of ciiaim:tm per Imlh. 
^leWorfcs supports the multij^e character widths available on tode^s dot 
nuMi printers, including both doubi&wide and proportional diaraders. 

The data liase piopand The data t>ase program in AppleWtorfcs, like th e 
other AppleWDrks modules, insists on having the entire data file being 
manipulated available in memory. This is not unusual in programs for the 
Apple II, but many CP/M users find it odd indeed. They are used to programs 
such as W/ordstar and dBase // that work with disk-based files. These 
programs load only the actual part of the file being manipulated into 
memory. CP/M fans complain a lot about programs such as AppleWorks that 
can't deal with targe, disk-based files. The difference, of course, is that disk- 
based programs must access the disk constantly They tend to operate with a 
deliberate slowness, while programs that deal with memoiy-resident data 
are lightning fast Both have tiieir place in die world. Speed and memoiy- 
resident files, used by such early Apple II best-sellers as VistCalcand i^ppie 
IVHter, are the Apple II tradition. 

By limiting itself to memoiy-resident data, the AppleWorks data base 
prc^ram is to provide some outstanding features not usually found in 
data base programs. One is the standard data base display, shown in the 
middle of flie top raw above. This is called tiie multipleirecord layout It 
aUowsyoutoseedOoilunmswiMrthofinfofnnationparre^^ 
you select Since each record k displayed on one line, you can see the same 
fields fiom 15 records at once on the screen. The anrow keys allow you to 
saoU fonward and backward through the file. As in all AppleWorks programs, 
the open-apple key in conjunction witii tiie number kc^ will move tiie 
display to any part oFthe file (open-apple-1 takes you to the beginning, open- 
apple-9 to the end, otiier digits to points in between). 

Pressing open-apple-Z in the data base switches to the single-record 
layout Whatever record tiie cursor was on in the multiple-record layout is 
shown in full in the single-record layout A single record can hold no more 
information than win fit on this page. The infomiation can be 



itBtiBi/Mb/emtK 



Eccipot mth mm 



ZIHMltiplic4ltwi t 



Trf thtrr or wm > cm 



Mteltiylicatton tmbli 



19l«A14«t 



*ti*i9* «Ar«C4 .MdM KtfdW 

tAlOkM tAIdlCI tAie*M «AI0*C4 Mlt.M 4«)«««4 .AIIW* 

*Mitt* **tll»04 *Atl»E4 .A11«P4 ^ll>e4 tMIHM 

tM2«C4 tA12MH ^l>ttE4 4A12*M 4AlZii64 tAIKM 

MIMM M1M:4 .A13«I>4 *A13«E4 ♦AlJ.f4 .AtSvM «AI3W4 

«A14*»4 .*(1tC4 «At4«M *AI4*£4 *AM«F* «A14«e4 

MlStC4 .A19*M .AIME* tA15*F« tAlSuM .AI9*H4 

4IU««M «M4*C4 *M6H)4 .A14K4 .AI4.F4 .AU>«4 >AI4«*H 

IM7W4 *M?«C4 «AI7«e4 .Air*F4 iAI7ie4 .*17«H 



trft mtry or vw • cn 



many as 50 categories or fields, no single field will hold more information 
than will fit on a single line— 76 characters if you use a onecharacter 
category name. As supplied by tiie fiactoiy, AppleWoiks allOMS 3.360 reomte 
per file, but Applied Engine^^s iWlwoilis software imjeases this to over ' 

4,000. 

The spreadsheet* The AppleWorks spreadsheet has several impressive 
features. The first is its size— 999 rows by 127 columns. An undocumented 
feature of the spreadsheet however, is that only 60 of the cells in a single row 
can hold formulas. Usually you can get around this limitation, however, once 
you understand whaf s going on, by continuing a series of formulas down 
one row. All 999 cells in a single column, on the otiier hand, can hold 
formulas; all 127 cells in a single row can hold values or labels. How many 
cells you can actually fill, of course, depends on howmuch memoiyyou have. 
Apple's documentation says a 128K csomputer can handle a ^»eadsheet 
witii about 6,000 filled cells. 

Mother interesting feature of the spreadsheet is its ability to sort a block 
of rows according to the data shown in one of the spreadsheet's columns. 
Forexample,ifyouusedtheAppleWorks spreadsheet to aeateagrade book 
ami enteied studentfs names in the fiiBt column and their SGoi^ 
test in colunm two,you could ^sily rank the shidents fay order of test scx)re 
—from lowest to highest or from highesttolowest Allerthat you could put 
them back in alphabetical order by sorting the same rows on the data in the 
name column. 

In tiie spreadsheet zoomingwitii open-apple-Z switches between standard 
spreadsheet format and a format Uiat causes the formulas within the cells to 
appear Only the portion of tiie formula that fits within tiie cell widtii will show. 
If you print from tiiis display, your hard copy will also showfcnmulas ratiier 
tiian the resulting data. This can be a very useful feature. 

none of Uie tiiree AppleWorks programs is the most powerful in Its class. If 
you have heavy-duty word processing to do, Apple WWteris better. Supercalc 
5a, which can generate graphs and use textual values, among other features 
not found in AppleWorks, is a more powerful spreadsheet (but why is its 
maximum size limited to 254 rows by 63 columns?). Disk-based data base 
programs such as General Manager and DB Master are more suitable for 
data bases with large recoids than the data base program in i^elbrks. 

AppleWorks more tiian makes up for its relative lack of powi^on a one^n- 
one basis, however, witti tts tight integration. Ail tiiree AppleWorks (H-ograms 
use similar, if not tiie same, commands. But more importantiy, tiie tiiree 
pFograms are dose^ knit lay tiie Appl^rks Desktop. 

Hie AppleWorks Desktop. The desktop metaphor is something 
AppleWnks shares with the Nadntosh. Having worked with both, 1 find the 
Hadntosh desKU^ to be &r more glamorous. However, the ^pleVKnks 
Desktop is far more usefiil. Itfs fast— bc^ in execution speed and bi ttie 
speed at whidi you can give commands. Yet if s easy— tiie Desktop is entire^ 
menu-driven. 

Like many otiier Apple II programs, tiie AppleWorks Desktop uses what 
Apple calls the "magic menu" interface. At the bottom of the next page is a 
set of Desktop menu screens. The screen spown in tiie upper center is tiie 
Desktop's main menu. When you see this menu live on-Ki een, one of ttie six 
menu items is l^ghlightedytii an inverse ban You can move tiiebarl>yeftiier 
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pressing the number of a different item or by pressing the up or down arrow 
keys. When you press Return, tiie highlighted choice is executed. 

The "magic menu" interfeoe woriw beautifully in^^pleWorks. Unfortunately, 
this interface is out of fewa" at Apple Inc ricKwadays Apple encourages 
software developers to use a mouse/pull-down menu interface based on 
MouseText characters. This system is similar to that found on the Macintosh. 
Both Interfaces have a place in the world but more people than the 
computer magazines and marketers seem to realize prefier magic menus 
(including me). Unlike a mouse-based interface, magic menus don't require 
a flat emptyspace near the computer for the mouseto frolic in and they don't 
require removing one's hands from the Kqbmd every time a command 
must be pren. Lets hope the strength of ^pleWorks is enough to keep the 
magic menu interface alive and healthy 

The first three choices in the Desktop's main menu add files to the 
Desktop, allow you to work with a file already on the Desktop, and save files 
on the Desktop to disk. Unlike the Macintosh desktop, which is really just a 
fancy disk directory, you can actually load files onto the AppleVforks Desktop. 
Up to 12 AppleWorks files can be on the Desktop at once. 

Ifyou catalog a data disk holding AppleWorks data files fi'om Basicsystem 
(AppleWorks is ProDOS based), you'll find the files have unique file types. 
AppleWorks word processor files are identified with the three letters AWP, 
data base files with ADB, and spreadsheet files with ASP. Thus, \A\tn you load 
an AppleWorks file onto the Desktop, AppleWorks knows what kind of file it is 
and executes the appropriate program when you decide to '\w)rk with " that 
file. There is no way within the context of ^pleWbrks to 'Yun" the word 
processor or to "run" the spreadsheet What you do is add a word processor 
file or a spreadsheet ffle to the Desktop and begin to work with it 

The second screen in the center below shows what happens when you 
choose the second item on the main menu, 'TYork with one of the files on the 
Desktop." A Desktop /mfev appears on the saeen. It too, holds a magic 
menu bar. You use the bar to select which of the files current)^ on the desktop 
you want to work with next 

An important feature of AppleWorks is that open'apple-Q(uick change) 
can be used to call up the Desktop Index fi-om anywhere within AppleWorks 
(whether you are deep within desktop menus or in anyone of the tiiree main 
programs). Open-apple-Q allows you to immediately choose a new file to 
work with. This means you can hdm several word processor or spreadsheet 
files on the desktop at once and quickly switch between them. Or you can 
switch t>etween a data base or spreadsheet file holding your data and a word 
processor file holding a report you are writing. Or you can instantly switch 
bdwcen the budget you are working on in a spreadsheet file toyour personal 
phone directory in a data base file or to your personal calendar in a word 
processor file. Ttiis is where ^pleWorks gives you real power oomp^ed to 
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stand-alone programs. (Open-apple-Q is also a handy command to use 
when you simply want to see how much space is left on the desktop— the 
amount appears in the lower ri^t comer of the saeen whenever the 
Desktop Index is present as well as at some other times.) 

The clipboard. AppleWorks provides a "clipboard" you can use to move 
data between any two files of the same type. Spreadsheet rows, Including 
formulas, can be moved from one spreadsheet file to another. Text can be 
quickly cut from one word processor file and moved to another. Data base 
records can be moved firom one file into any other (if the two files have 
different numbers of fields some data may be lost but as much of the data as 
can be moved will be moved). You access the clipboard with the open-apple- 
C(opy) or open-apple-M(ove) commands. (Copy aeates a duplicate of the 
selected material and moves it to or from the clipboard. Move deletes the 
selected material from the source while moving it) 

In addition to using the clipboard for moving data between files of the 
same type, data base and spreadsheet reports can be printed to the 
dipboard. Ths^ aK>ear there just as they woiUd if they had been printed on 
your printer. Onc^ these reports are on the di{^oar4 they are word 
processor material, so you can move them into word processor files for 
fijther editing or to combine them vwth other information. 

Placing something on the dipboard deletes what was alreacty there. There 
is no other way the clipboard can be cleared except by quitting AppleWorks. 
This is basically good, but can cause problems when a large amount of no- 
longer-needed material is on the dipboard and taking up precious Desktop 
space. There is no way to see what's on the dipboard except by copying it into 
a file of the appropriate type. We'll examine some of the tricks you can do with 
the clipboard further in ftiture issues. 

Adding files to the Desktop. The two screen images on the left side of 
this page show the menus for adding files to the Desktop. AppleWorks 
mercifully allows floppy drives to be specified by drive number rather than by 
ProDOS volume name. However, it also allows files to be spedfied with a 
ProDOS prefix, which works great for users with high-capacity disk drives. You 
can specify a prefix or a different drive by choosing item 2, "Get files from a 
different disk" on the Add Files menu. 

When you choose to Add Files from the current disk, a catalog of that disk 
appears on your screen showing all of the AppleWorks files available. This is 
shown in the lower-lefl: screen image on this page, note that only AppleWorks 
files appear in the catalog. There are ways to load other types of files (for 
example, standard ASCII, DIF, and VisiCaloCormat files) into AppleWorks, but 
this isn't it We'll get to that in a moment 

Once the disk catalog is on your screen, you can scroll through it with the 
up and down arrows. You can select and deselect files for loading with the 
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right and left arrows. If you select several files, AppleWorks will load them all 
to the desktop at once, 

If the file you want to work with doesn't exist yet, or if its in a non- 
AppleWorks file, rather than choosing to "Get files firom the current disk" on 
the Add Files menu, you should select "Make a new file" 

The three screen images across the top of this page show the next menu 
that will appear, depending on whether you choose to make a new file for the 
word processor, tiie data base, or the spreadsheet 

If you are making a new AppleWorks file for the word processor, you can 
either make it fi-om scratch (that is, you'll start with a new, empty file), or you 
can make it fi-om an existing text file on disk, as shown in the upper-left 
screen image. 

Data base files can be made from scratch or can come from text files. 
Quick File files, or DIF files. (Text files for the data base should have a Return 
after each field or category. Each record must have the same number of 
fields. Records need no separators —AppleWorks figures it is at the end of a 
record when the proper number of fields has been read. You have to specify 
how many this will be before loading the file.) 

Spreadsheet files can be made from saatch or can come from VisiCalc- 
format files or from DIF files. (For a complete description of VisiCalc-format 
files, see the Januaiy 1984 DOStalk in SoftalK page 237, For more 
information on DIF files, see the February 1984 DOStalk in SoftMK page 
65.) 

Be forewarned, however, that if you decide to make a new AppleWorks file 
from some other type of file there are two problems. First of all the old file 
must be on a ProDOS disk. If its on a DOS 3.3 disk, you'll have to convert it to 
ProDOS first Even then, /^pleWorks won't allow you to select the file from a 
catalog as before. Instead you'll have to type in the file's complete ProDOS 
pathname. If you don't know its name, you have to escape to the Main Menu, 
choose "Other Activities", choose "list all files on the current disk drive," 
memorize or writedown the filename, and follow your breadcrumbs back 
again. 

This is quite painftil, especially if birds eat your breadcrumbs. A definite 
improvement for AppleWorks would be to allow any kind of file to be selected 
from a menu. A ftirther improvement would be to show ProDOS subdirectories 
in these menus, and to list their contents when they are selected. This would 
greatly ease the process of selecting files by pathname. 

Saving files. The two right-most screens on the previous page show the 
menus you get when you select "Save Desktop files to disk" on the Main 
Menu. The first saeen that appears allows you to select the files currently on 
the desktop that you want to save. All files on tfie desktop, along with thefr 
status (new/unchanged/changed/saved), type, and size will be displayed. 
You select the files you want to save as before, and press Return. 

Another menu then appears that allows you to save the files on the current 
disk, or to first switch to a different disk. AppleWorks does not delete original 
files until a save has been successfully completed. This means the biggest 
file you can resave on a floppy is half the capacity of the floppy. (If you have a 
bigger file, save it on a diff^erent disk or delete the original before attempting 
to resave it) 



You cannot lock or unlock files from within AppleWorks, though this may 
be a good idea for special empty templates of various types you don't want 
spoiled by mistake. You can lock AppleWorks files from Basic or with tiie Filer 
or lie Utilities. This prevents AppleWorks from overwriting the file, even if you 
mistakenly tell it to. 

When you use the "Save desktop files to disk" option from the main menu, 
the only types of file that information can be stored in are the three 
AppleWorks file types. However, just as AppleWorks can load information 
from other file types, it can also save information into other ^es of files. The 
only problem is that how you do it isn't at all obvious. 

The bottom three screen images on tiiis page show the menus you use for 
saving files in non-AppleWorks formats. To get to these menus you must 
be"working with" the file you want to save. Then choose open-apple-F(rint). 

Before we can say much intelligent about these menus, you have to know 
that AppleWorks lets you define up to tiiree printers for its use. One of these 
three can be a "custom" printer, the other two have to appear on a menu 
inside AppleWorks th^t has various Apple, Epson, and Qume printers listed. 

In the saeen images shown, two printers have been defined. One is an 
Apple Dot Matrix Printer, the second isn't really a printer at all, but a print- 
formatted text file. If you haven't used up your custom printer definition 
already, you can have one of tiiese by defining one and selecting "Print onto 
disk" when AppleWorks asks which slot to access the printer wiSi. 

Defining such a printer gives you an extra way to save files to disk. 

Important: unless you have done this (and named such a custom printer 
"formatted t&d"l the second option in the three screen images shown here 
will not appear in your own print menus. 

In the word processor print menu, note that files can be saved into text 
files in two different ways. The formatted text file will contain all tiie control 
codes that would normally be sent to your printer— such as the control 
codes for underiine and boldface. More importantiy, a formatted file will have 
Returns at the end of each line. The "text file on disk" choice, on the other 
hand, will eliminate all control codes except for Returns you have entered 
yourself normally this would be only at the end of paragraphs, not at the end 
of lines. The formatted file is more appropriate for preparing files for transfer 
by modem. The unformatted file is more appropriate for moving files to 
other programs such as Apple Writer, You do have a choice. 

The data base print menu shows you can print reports to the saeen and 
clipboard as well as to formatted, unformatted, and DIF files. The standard 
"text file on disk" choice gives you a file with a Return after each field. This 
kind of file is not suitable for entry into a word processor. Use tiie formatted 
file option for tills, or better yet print the report to the clipboard. The "text file 
on disk" choice, however, is suitable for dumping information into a file that 
can be accessed with an Applesoft program. Make up a report format that 
simply contains all tiie fields in your data base. You can dump ttie whole data 
base or selected (and sorted) portions of it into a standard sequential text 
file for ftiriher processing witii Applesoft. The Open-^ple subscription 
system is l>ased on tills trick. 

The spreadsheet print menu shows you can print spreadsheet data to the 
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base files, the "text file on disk" option will put a Return after each cdi This is 
unhancty if your intention is to use tht file with a word processor (print to a 
formatted text file or the clipboard instead), but wori^s quite well if your 
intention is to access the information from an Applesoft program. 

Help! I'm rapidly running out of room here, and weVe talked about 
nothing but AppleWorks so far this month, (note to new subscribers— this 
isn't fypical.) Howeven there m, a couple oi sources of Appleffiioite help I'd 
like to mention. 

Robert: Ericson (P.O. Box 16064, Rumford, RI 02916) has prepared a set of 
materials he calls Holes forAppleWbrks, Mch he sells for $10. These printed 
notes consist of the equivalent of more than 50 single-spaced AppteWoiks 
pages and are chock M of tips and tricks for using AppleWorks. 

The Appte^WbslKS Users (kmp (q/o Jim WIffis, 1300 liintcm St West 
Nomoe, La., 71291) collects and publishes notes, templates; revieMS, and 
similar material about Applellforiis. The group had eight disk sides of 
information in May and probably has more by now You can purchase this 
information from the group for $4 per double-sided disk, or you can send in 
a disk and return postage and get their stuff at no additional cost You are 
encouraged, of course, to put your own ideas, findings, and other material on 
the disk you send in so your stuff' can be added to the dub library. 

The possibilities here are endless. Rather than simply having a library 
shiffed full of Basic programs, as most users groups do, this library can have 
reports and reviews in word processor files; useful, searchable data in data 
base files; and programs in spreadsheet files. One of the things on the first 
disk, for example, is a data base file on the group's own membership. Other 
possiblities would include a data base of software for the Apple, of 
^pleWorks-related magazine artides, of Apple users groups, and so on. 
(The sample data base file shown on page 58 comes fifom one of these 
disks.) 

There% lots more to talk about iidien it comes to AppleW9rfc& 
month. 
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Apparently the only program ever written that used MouseText's running 
man was our Humantext Demo in the April issue (page 27). ^ple has 
announced that ttiose diaracters will not appear in ftiture versions of 
NouseText and now warns soibme, developers not to use them. Apple hasn't 
revealed what land of charad^milll rq>lace the running man. 

Hie NooMflQil characto set was designed by Bruce Tognazzini, an 
^ple II wizard who has been around since the early days of Apple. Ife 
recent^f wrote a very funny letter to Call -ARRLE. (Ju^ 1985, page 41), in 
which he explainswhy the NouseObct characters ended upwh^e theydid (a 
hardware problem, he says). Ill reprint the letter if I can get the required 
permissions. 

The internal structure of AppleWorks files is completely documented 
in a paper available for the asking ft-om Debra Hara, Mail Stop-22D, Apple 
Computer, 20525 Mariani Ave, Cupertino, CA 95014. 1 wish it used the Apple- 
compatible dollar sign for hexadecimal numl)ers. Instead it uses the CP/M — 
IBM method of following hex numbers with an "H". i keep thinking H is the 
last digit but can never find that key on my hexadecimal calculator. 

The ^plel^ network's Apple 11 documentation is available in a 
preliminary form, though the combination hasn't yet been officially 
announced This stuff is expensive, but necessary if you're interested in low- 
cost networks. Rrst you need Inside AppleTMK which is $75 plus your state's 
sale's tax fi-om y^pte Computer, 467 Saratoga Ave, Suite 62X San Jose, CA 
95129. Then you'll need AppleMk Developer's Holes for the Apple //e, which 
is $25 plus your state's sales tax fi-om Apple Sofhtfaie Group, Mail Stop 4-X 
20525 Mffliani Ave, Cupertino, CA 95014. 

Hie old retiaMe Disk D has been discontinued by Apple, though 
equivalent units are still available from other vendois. The Disk II has been 
r^laoed t^a new half-height drive called the UniDisk. The UniDisk is 
aesthetically nicer, but the catdi is that the controller card that the UniDisk 
requires is not compatible with older Disk II controllers. Either controller 
can aocomodate two drives, but Apple says the newUniDisfc and old Disk II 
can't share a common controller card. Of course, Apple also says the Apple 
lie can't use either of these drives either, but companies are selling adaptor 
plug3 that allow a Disk II to work with a lie (For example, WQE International, 
Rt 202a Peterborou^ rifl 03458, 800-227-1560, advertises a Disk II/Apple 
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but Open-^ppfe will pay hard cash for a publishable article on the Disk 11/llc 
connection and why or why not the Disk II and UniDisk can't share a 
controller card. Inquire vwthin. 

This month's cartoon is by Rich Tennant Rich used to be a mainfi^ame 
programmer; he says the experience left him with a gusher of malice that will 
last the rest of his life. He is coauthor of the / hate Computers Book (Hayden 
Book Co., \sm 0-8104-8000-X, $4.95). In a related development, the August 
inCMer (page 36) includes a worthwhile article by Jack McComack that 
shows how to hook a lie to your car's dashboard or any other 12 volt power 
source with a few dollars worth of parts. You'll still need a monitor, but if 40- 
oohimn mode is adequate, McComack says 5-inch batteiyi)owered tdeti^cms 
are available for about onefifth the cost of Apple's flat panel display 
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Hackm, Herosof theGanpntcr itevotiitioB. by Steven Um^ 

fire in the VaSlef, The Making of the Peminal Conqiiiler. By Paul 

FVeiberger and Midfiael SiMEdne 

The Little Kfa^dom. Hie Mvate Simf of Apple Compnla; ^ Michael 

Moritz. 

When the president of the Apple user group here in Kansas City goes on 
vacation, she takes her Apple lie with her. She drives around the country 
calling up local bulletin boards to add to her collection. After last year's trip, 
she suggested that the software, tourism, and hostelry industries get 
together and "put a sticker on all motel office windows depicting a computer 
with either an M for modular or an A for acoustic (and for the one motel 
owner I ran into, a computer with a slashed red circle around it)" 

If s possible, I'm told, to go on vacation and leave the world of computers 
totally behind, but I have a hard time imagining it Instead of lugging a 
computer with you, though, how about a book? Here arc three of them— 
none need electrical outlets — that will keep you frcmi straying too fas from 
the vflEUfmth generated by ROMs and RAMs. 

All tiuee are historical looks at personal computing with emphasis on the 
Apple II. 

fiackers has the broadest scope. It begins in the late 1950$ with the 
adventures of some students at the Massachusetts Instihite of 
who used one of theiMirid^fiist trai^stomm c»mpii^ as if it hadt^eenan 
It Olds v^lh an extensh% lodc at the people behind the large, Apple 11- 
centered software company, Sien'a On-Line, In between we find Wbzni^ and 
the Homebrew Computer Club. Hackers focuses on the hardware and 
software wizards of the computer age and what they stood for. 

Fire in the Valley concentrates on the forces that gave us the personal 
computer. Most of these forces seemed to converge just south of San 
r^ncisco, in the Silicon \^]ley, during the late 1970s. Since Apple is one of 
the major figures in the history of personal computing, it has a major role in 
the book. What fire in the Valley did for me was bring together hundreds of 
loose ends and fragments of things I'd read about but never understood. 
Things like what's an Altair, who is Dr. Dobbs, and why is CP/M. 

The LAtUe t^ingdom is an historical look at Apple itself. Here's more than 
you'd ever want to know about Jobs and Wozniak, But it also introduces 
other important ^pie-related people you've never heard of, such as Rod 
Holt Chris Espinosa, Ranc^ Wigginton, Alan Baum, and many others. This 
bo(^ would be t>etter if it gave more of the technological histoiy of Apple, but 
the stories of stock options and of programmers "calling one of their new 
supervisors a Sdhivare Nazi because he was steadfastly opposed to revealing 
details about the internal medianisms of the machine" are veiy interesting, 
indeed 

Hackers, by Steven Levy {Anchor Press/ Doubleday, Garden City, N.Y.; ISBN 0-385- 
19195-2). $17.95 

Fire in the Valley, by Paul Freiberger and Michael Swaine (Osborne/ McGraw-Hill, 
2600 Tenth St., Berl^eley, Calif. 94710; ISBN 0-88134-121 -5). 
The Little Kingdom, by Michael Moritz (William Morrow & Co, Inc., 105 Madison 
Ave. New Yorlc. N.Y. 10016; ISBN 0-688-03973-1). $16.95 
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Avoiding hi-res memory 

I have written a few Basic programs for my elemen- 
tary school The better I get at writing these programs 
{offering more user options, combining tutorial and 
drill, etc), the larger the program gets so that it runs 
into the graphics area. I've broken the last program I 
wrote into discrete parts and access each part with 
Pranr D$;"RUI1" but this constant waiting for access 
to the next part is boring and tiresome for the kids. 
Any suggestions? 

Doris M. Kneppel 
Kinncion,ru, 

There are semM ways around the problem you 
are experfencfnf. They fail into two categories- 
loadbfig your uMoie program into the computer but 
aomding the graphics area or continuing to use 
smaller program parts but feeding up the transfer 
from one part to another. 

The easiest way to speed transfer is to use a high- 
speed DOS, such as DiversiDOS or ProntoDOS, 
which are DOS 3.3 work-a-likes, or Apple's newer 
^oDOS. which is similar but different If your 
school has Apple lies or 128t{ Apple lies, you could 
also use the extra available memory as a RAM disk to 
speed things up. With DOS 3.3 this requires a special 
software package such as Beagle Bros' DiskC^iik. A 
RAM disk is instsdled automatically on 228li machines 
if you are using FroDOS with Applesoft 

The other possibility — avoiding the graphics area 
entirely— can be accomplished fairly easily by 
simply tricking DOS into loading your program 
aboue the graphics area. There are 22,016 bytes of 
space auaOaNe al>oue hi-res page one. Below it 
where Appiesofi programs and variables normaUy 
live, there are only 6,144 bytes available. So Just this 
simple trick will allow yourprogmm to be three-and- 
a-half times longer. 

Whatyou have to do is pofce azero at the program's 
new st2anng location, reset the "start of program" 
pointers (see figure 1 on page 4 of the January 
Open-Apple), and immediately RUlia new program. 
For example, if your program is called BIQ PICTURE, 
write a separate startup prpgiam that does thisi 

m REM fflOweB program start to S4000 

2e 3TflRT=ie384 

30 POKE 5TfiRT,0 

40 POKE 104,STflRT/25B 

50 POKE 103, START -(PEEK( 104 ]«25G1 

G0 PRINT CHR$(4]rRUN BIG PICTURE" 

If you want to put yourprogimiabom both M-res 
pages, change the value ofSTARTm line 20 to24576. 
That will give you 13,824 bytes of program space— 
still more than double whatyou had before. The new 
program location wUl continue to be used if you RUTi 
more programs. Tb reset the location back to normal 



underDOS5,5,youcanusetheFPcommand. Under 
ProDOSs rerun ^asiasystem. 

A pToNem wm this trick is that it leaves the 
memory below the graphics area unused. Another 
solution to your problem is to spUt your program 
bito two pieces; one below the graphics area, one 
2d)ove. The Beagjle Bros disfcSilkon Salad indudes 
a program that wUl do this; so does CALL -A«P,PX.£. 
in Depth #1 All About Applesoft fpage 81) and the 
June and October 1980 issues o/Call -A.P»P.L.E.. 

No thank you 

I wrote a letter to So/talfc's Il^l1teii-Na|lie column 
six weeks before they folded. Admittedly it was a trick 
question, but 1 tliink they took it pretty hard. 

Brad Walters 
Boston, Mass. 

Fleeese don't send that que^on to me. 

HCOLOR, block reading 

Michael Ching states (June issue, page 47) ttiat on 
power-up, the value of HCOLOR defaults to white on a 
II-Plus, but black on a lie. This ma^ be generally true, 
but not universally. It appears Applesoft itself does 
not initialize HCOLOR, so the "default value" is 
whatever happens to come up in the RAM chips. I was 
once involved with a commercial product that con- 
tained a dismembered II-Plus and did a lot of graphics. 
Dozens of units were installed with no apparent 
graphics problem. One day we were surprised to hear 
from the factoiy that a particular unit would not 
display any graphk:s in program X until you had first 
used program Y or Z. Investigation finally revealed 
that program X never set HCOLOR and unwittingly 
depended on having the Il-Pkiscome up using v^ite; 
our "defective unif was an oddball il-Plus that came 
up using black. 

A comment by Ken Kashmarek (July, page 56) 
makes me think the following suggestion could save 
a few people possible problems. Kashmarek is doing 
machine-language routines to access ProFile blocks 
directly by setting up a command table at $42-$47, 
then calling $CsXX where s is the slot number and XX 
is the value at $CsFF. This may work fine for the 
ProFile but not for other hard disks; I would recom- 
mend instead that the ProDOS disk vector table at 
$BF10-$BF2F be inspected to find the address of the 
disk driver routine. 1 know of at least one hard disk 
system (Qenie) in which the routine at the $CsXX 
address is a set-up routine; before performing the 
operation requested in the command table it checks 
all ProDOS vcrfumes on all drives connected to Uie 
card and selB them up appropriately in the disk 
device tablesat$BriO and up; in particular itmodifies 
the stored vector that led to its being invoked so that 
the next call to access the volume will go through a 
normal access routine. In this case repeated calling 
to $CsXX to access disk blocks wouldn't be particularly 
harmful, just slow; but conceivably other hard disk 
systems might tolerate it less benignly. In short the 
vector $CsXX only shows where the interface card 
wants to be called the first time ProDOS uses it if 
calling it makes it change its address in the disk 
vector table, it is good manners to call the latter 
address. 

Robin Ault 
newtonville,Mass. 

TTianfcs for pointing Uiis out Kashmarek actually 
wrote me that he accessed the ProFile with JSRs to 
$C5EA; I took the liberty of changing it to $CsXX so 



that the information would be useful to peo»p{e 
othertifftesofharddfims.Asyoup(Mout however, 
$CsXX is not necessarily the best entry p<Ant just the 
first one. For the record, the table you refer to at 
$BF10 holds 16 two-byte di^ device driver entry 
points in the following order; slots to Z drive h 
slots through 7, drive 2. The slot entry points are 
reserved. /RAM appears as slot 3, drive 2, Slot/drive 
combinations with no device point to an error 
handler. The ProDOS Technical Reference Manual 
talks about this stuff in cormlersd>ly less detail on 
pages 92 and 110. 

Integer BasK 

flow can you run Integer Basic programs under 
ProDOS? 

Robert C Piatt 
^mrillo, Texas 

Compatibilily of foture machines from Apple is 
essential, but must they run APPI^VISIOff as you 
insist in ttie July issue (page 50)? For most of us. 
Integer Basic has been dead for so long that it doesn't 
even smdl bad anymore. 

William Cutrer 
Dayas« Texas 

7b run an Integer program under ProDOS 
you would need a sy^m program somewhat like 
Applesoft's Basic^^m. Ir^etsy^em", orwhsd,- 
everyou trught call it howevet would hasve to hold 
the entire Integer Basic inierpreter as well as the 
DOS related stuff of Ba^csystem, I don't think 
developing such a thing would be a massive under- 
taking as long as Apple would license you to steal 
code from Int^er Basic and Basicsystem. 

Idon'tthinkthere wouid be much remuneration in 
it but writing Integer.sy^m" would ma^e a nice 
hobby for some assembly language hacker. To my 
knowledge it hasnt been done yet 

Insi^g that future Apple Us can runAPPLEVISIOFi 
simply guarantees that a number of thmgs stsq^ the 
same with Apple graphics, sounct dis^ and memory 
configurations. Though it hurts to say such a tMng 
about the first computer language I euer learned. / 
agree Uiat Integ&r Basic is as dead as Latlrt 

ProDOS drive size 

The ProDOS read/write block routines require a 
unit number in the format DSSSOOOO, where D is the 
drive number and SSS is the slot Is it logical to 
assume the drive number of a hard drive is 1? 

I wite a computer newsletter for nr^ employer, a 
county schools office. I'd like to occasionally pass on 
information mentioned in Open'Apple. Do you have 
any objections as long as I give OpewApple as the 
source? 

Bob Crocker 
Yubaaty,Caltf. 

If a hard drive supports just one volume, the read/ 
write block rouUnes treat that volume as drive 1 
(D=Ol If the drive has two volumes, the second is 
treated as drtoe 2 (D=l). 

ProDC^ aUows a majdmum of 14 volumes to be 
accessible, or on-line" at one time. Eadi of these 
can have up to 65,536 blocks (33,554,432 bytes) of 
storage space, for a totalofs^>out4.7 billion bytes. (A 
shelf of Open-Apples unth ihat much data would be 
over 12 feet long,) By using Removable media", 
such as a floppy disk or a more automated type of 
device, any amount ofbnformaUon could be handled 
by ProDOS. 
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ThemlkaBy, all 14 volumes could be on one 
physical device attached to a card in a single slot, 
howeuet the ProDOS kernel wmdd pretend they 
umeUs^mraiedGJiBesins^aaatesiots, 

Here are the ""mHT or "deoioe" mifiil>ers that 
DSSSOOOO translates Into: 

ProOQS unit or device numbers 

■lot: 1 2 3 4 5 6 7 

drive 1 sie s2e sae S40 $5e sge m 
driM« 2 sse $A0 $80 see $00 see $F0 

In some situations, FroDOS uses the lower four 
bits to designate the type of device, for example, in 
the ^device list" (DEVLST) ProDOS keeps in the 
system global page at$5f32'3f, OlndlcatesaBtsIc//- 
tike floppyAanAppleProFie,andFMks^/EAM. 
The iSlder shows up as a 5, 

Ideas ejq>ressed in Open-Apple are open game 
foranyone,justasthey aretnsofty written materia. If 
you (Me GlpeiH^ifite as fftesotuce ofsudi Ideas, 
lioweuer yow r^wsHetters uM fM easier and j^our 
stamps will stidc better. 

77te exact wordlnQofthe Ideas ei^ressed In Open- 
Apple is copi^righted. The legal doctrine of Jair use" 
says you can use short portions of my wording if 
you indicate that the material is a direct quote and 
you cite the source. I do this to other people all the 
time; look around Open-Apple for examples. I will 
also allow Apple user groups and significant others 
to quote whole articles from Open-Apple on a word- 
for-word basis from time to time, but this is more 
complicated and requires aspedfic written request 

Truly mixed 

Is there any way to change the number of text lines 
on a mixed text and graphics page? Can I use a 
saeen that is half and half? 

Duncan On 
Heber City, Utah 

Indeed, you can, usir^ assembly language on a 
He or Uc. It can also be done on a II-Plus, but you 
have to solder a 7-1/2 Inch piece of wire between a 
couple of pins. The details of all this would fill up a 
whole issue of Open-Apple. Instead, I'll refer you to 
the bible on this technique, Don Lancastcr'sEnhanc- 
ing Your Apple 11 Second Edition (floward W. 
Sams & Co., 4500 West 62nd St Indianapolis, IPi 
46268, $15,951 If you have an Apple lie or Uc, start 
on page 252, where notes on using the techniques 
with these machines are found, then go back and 
examine chapters 4, 5, and 6. 

Most people dont belieue it bud Lancaster's 
tedvfdqueyoucan mbc any or all Apj^e U graphics 
modes on me screen—anyplace, even left-right 
splits. The half'text/half-graphks you^re intere^d 
in just the beginrir^ of the possibilities. 

Gorib-Grappler cross 

Can you tell me how to convince my Apple II-Plus to 
have my Qrappler-Plus tell my Gorilla printer to print 
graphics? I've tried tbe contn^l Q command, but it 
doesn't work. 

Paul Low 
Riverdale. Md. 

// you don't get anyMr^ at aH on your QoriOa 
wlien you print the control-l, G, yoiitmim^My not 
Mngitright The following programhasanexampie 
of how to do it 

If you get garbsge on your Gorilla in response to 
wrttd-h d you need to reset the dip switches that 



tell your OrE^pler-flus u^klrui of printer you have, 
77te On^ppter manual doesn't specPca% say It 
suf^Hyrts t/ie Gorilla but the Qorftta probably piinis 

graphics In response to the same commands as one 
of the supported printers. If you fcnow something 
about this, it may help to reulew the Qrappler-Pius 
manual. 

Otherwise, proceed li/ce this. Put the foUawinQ 
startiq> program on a disk that has a printable 
grsfiNemU: 

10 HGR 

20 PRINT CHR$(4);''BLQRD GRAPHIC, fiS2000* 

30 PRINT CHRS(4)-."PRai" 

40 PRINT CHRI(9];"G" : REM control-I, 6 

50 PRINT CHRi(4);"PRIt0'' 

S0 TEXT : END 

TUm off your computer. Remove the M and find 
the dip switches on your Qrappler, There are four of 
them, so they canbesetin IBpos^bfecombmations. 
Start trying the combinations one-by-one until you 
find the one that works. Set the switches in your first 
configuration and turn the computer on to start up 
the above program. Check what appears on your 
printer If it's a graphic, you're done. If not, turn the 
computer off. try another combination, and repeat 
This method can be used to discover the right 
combination for any interface card and printer --if 
there is one. 

The hard disk life 

I lost 16,000 sectors on a Sider when I foolishly 
reset when printing from Apple Writer (ProDOS 
version). It bad blocked them and I couldn't work 
around it— had to reformat and lost many files I 
shouM have backed upl Any hints? 

Donald Beaty 
San Mateo, Calif. 

Boy that's scary. I can think of no theoretical 
reason why pressing reset while printing from 
Apple Wte should harm the ^der, but I'm not 
wSlbiQtotryltmniys^nitomakesme, 




There £s a tmg in the Reset trap demonstMon 
program in the February issue (page 16), It prevents 
a disk from booting corredly if the patch is made a 
permanent pari of DOS 5.5. Add this line to the 
program to get rid of the problem: 

S? POKE 40382,21 

BSAVE,T, and CREATE 

Your July issue (page 51) correctly states that 
BSAVE, when used with the Type parameter, works 
only with pre-existing files. However, there seems to 
be no reason for this and I consider this inability a 
bug in Basicsystem. 

1 discovered the bug while implementing FIQ- 
rORTH in ProDOS. I wanted to save data blocks using 
as little code as possible, however I wanted the data 
blocks to use standard text files so Uiey could be 
edited with wc»d processors. I recognized that BSAVE 
could solve my space problem, but to use text files I 
would have to CREATE new files first thus deaeasing 
speed and inaeasii^ code iengtfi once agaia 

TheieftHellooked for the BSAVE code to fbLthebug 
andwitti1hehe4)ofttiedbassemblyinthesuppleifnefit 
to Beneath Af^}le ProDOS, found 1 could do it I was 
able to accomplish this because the command 
parser puts the file type code m VFYPE ($BE6A) and 



then BSAVE and CREATE both pin t IhR 4piL 
wasting code that I put to better use. Hk ac 19 
patches: 



bload relocated disassembly 



adr 


adr 


and 


comments 


Basicsystem 1.1 existing BSftV£ code 


S37F5 


$flors 


m m 


LOfi fl$0G assume BIN 


$37F7 


$fiDF7 


60 SR BE 


5TA $BElGfl put at VTYPE 


$3?rfl 


$flOFA 


BO B8 BE 


STR $BEB8 put at satinfo 


$37FD 


$fiDFD 


RD 56 BE 


LOR $BE5S type giv/en? 


$3600 


$AE00 


29 04 


tt$84 


$3B82 


Sf€92 


D0 0E 


BNt SAEIZ yes- -error 


$3804 


$flE04 


20 46 flD 


JSR $RD4G goto CREATE 


$3741 


$flD41 


R9 0F 


LDR tt$0F assume SYS 


$3743 


$flD43 


BO 6R BE 


STR $BESfl put at VTYPE 




$m& 


-> 


CRERTE file 


modifications for S5RVING i 


new files of any type 


$37r5 


SflOFS 


RE Gfi BE 


LD>: $8E6R get parsed type 


J37F8 


iflDFB 


RD SS BE 


LDR $BE5G type giyen? 


537FB 


JflDFB 


29 04 


RNO tt$04 


S37FD 


$ROFD 


D0 02 


BNE IflE01 yes, branch 


$37FF 


SflDFF 


R2 0G 


LDX a$0G no, use BIN 


$3801 


smi 


BE 88 BE 


STX $BEBB put at setinfo 


$3B84 




20 43 flD 


JSR «flD43 goto CRERTE- 3 


$3741 




fi2 0F 


LOX tt$0F wsmm SYS 


$3743 


$ftD43 


BE Eft BE 


STX SBC6A put at VTVPE 




Sffi4£ 


> 


CREATE file 



Nark Jackson 
Chicago, 111. 

Your modifications look very good parikiMny 
since they reguire no addUionai space. In testing 
than, howemr, I mUced that the record length for 
text fUes creaM this way is set wrong. Directory 
entries under ProDOS include a field called AU)UYPE 
that Is used for different things depending on the 
type of file, riles of types BUI, BAS, SYS. and VAR use 
it to store the default loading address of the file. This 
IS the number thatBS/S/EpulsinUie^nredoruuMh 
your technique. 

TXT files, however, store the file's record length in 
AU)LTYPE. Thus, TXT files aeated with BSAVE have 
very strange record lengths. / suspect Basicsystem 
prevents BSAVE from creating new non-binary files 
to avoid problems with AUXJIYPE. however, your 
modifications can be valmble if used with an under- 
standing of the potential problems. 

Inddentaiiy, a subsaiber recently t^ped me off to 
themostbUere^tnQimofAWLTYFEtoMe.^to- 
Works flies use AUXJYFE as a bit mask that 
remembers uihiich (^laractais of a fi^s name are 
upper case and which are l<Mer case. When you 
catalog an AppleWorks fUe uM Baslasystem, it will 
always appear in c^pitais^ toftft periot^ in^ead of 
spaces. Just like aff offier ProDOS fUenames, Prom 
inside Ai)pleWorks, however, filenames can be upper 
and lower case and can include spaces as well as 
periods. The 16-bltAUXJYPE value tells AppleWorks 
how to display the 16 character filename. Lower- 
case period m displayed as spaces. 

Nibble bytes lounge 

Shocked by your expose (June page 45) of our 
alleged hoarding of available exdamadon point3, 1 
asked our controller to do an internal audit of our 
stocks! Much to my surprise, it divulged that ttiere 
wasa large orate of said points sequestered in a back 
stockroom, apparently an impulsive acquisition by a 
former ^^managi^I^^ipalled I contacted theMPA, 
theAMandtheSFffS^whoiiil independently ow^^ 
a lotteiy for point distiibution to neec^ pul)lishcaB, 
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based on their immediate exclamatory needs! Hope- 
fully, we will see a resultant softening of the point 
market although this may in turn afFectthe availability 
of hypens — and ellipses , . . 

David Szetela 
Mana^ng Gditon nibble 

PEEK(978) problems 

This 57-year old has been struggling through 
Open-Apple and, believe it or not some of it seems 
to rub in. Fantastic stuff. 

The program for testing the effects of the Garbage- 
man in the January issue (page 4) gave me a problem. 
Line 85 indicates that if PEEK(978)=190 then ProDOS 
is active, but that's also what you get when using DOS 
3.3 and GPLE.DM (the version of GPLE that works with 
DOS 3^ moved to the language card). 

M noticed you are also using PEEK(978) in other 
programs, and 1 thought I'd warn you you may have a 
problem with GPLE users. 1 have never learned to type 
in code without using GPLE. 

VITill Thompson 

Buffalo Grove, 111. 

Things transpire within Open-Apple at different 
levels, I try to fix it so that anybody interested in the 
J^ple II can pick up some worthwhile stuff— but less 
experienced users will undergo more puzzlement 
than others. But remember— the more you read, the 
more you underhand; the moreyou understand, the 
more you understand. 

FEEK197B) sewes two different func^ons. In some 
programs, such as the one you mention in the 
January issue, it is used to determine whether DOS 
3.3 or FroDOS is active, in others, it is used to 
confirm that DOS 3.3 is at its standard 48K location. 

PEEf^(978) usually works for these tests because 
standard Apple operating system protocol calls for a 
DOS warmstart ^'vector" to be stored in bytes 976- 
978 ($3D0-3D2). Byte 978 ends up holding the 
"page" or high-byte address of a routine inside DOS. 

Mere's what the value inside byte 978 usually 
indicates: 

Situation indicated by value in byte 37B ($3D2) 

<157 DOS 3.3 actiye, computer has < 4aK 

157 DD5 3.3 active at standard 4BK positiDn 

190 ProDDS active 

191 DOS 3.3 active on language card 



However, as you point out not all programs that 
move DOS 3.3 to the language card feauc 191 in byte 
978, 1 think most do, but GFLE DOS MOVER doesn't 




open-Apple is a trademark of Open-Apple newsletter. Apple 
Computer and Open-Apple are two different, unrelated, inde- 
pendent companies that wish everyone in the world had an 
Apple II. 



Consequenay, the DOS 5,5 us ProDOS test fails. You 
GPIX.DN addicts may find a different test more 
appropriate-~checkbyte977 instead, ProDOS^res 
a zero here; DOS 3,3, on the other hand, keeps 
something greater than zero here in all situations I 
know of. 

ynhen programs check to see whether DOS /las 
been moved, however, only the test of byte 978 will 
work. You will have to discern yourself which pro- 
grams need to have 978 changed to 977 and which 
should be left at 978. All programs that poke changes 
into DOS 3.3 should check 978 to make sure DOS is 
where it's supposed to be. Ifit isn't, the pokes go into 
thin air and have no effect, or worse, ime a drs^tic 
effect. 

Converting CONVERT for MouseText 

1 have an enhanced lie and also a He Using either 
of these systems with the ProDOS COMVERT utility 
causes the inverse bar that highlights Renames to 
show the names in MouseText 1 finally got tired of this 
and went looking for a solution to the problem. 

The following Applesoft routine fixes the problem. 

10 PRINT CHR$ (4); "UNLOCK CONVERT' 

20 PRINT CHR4(4);''BL0flD CONVERT, TSYS.flJZeee" 

30 POKE 2G523,W 

40 POKE 2G711,G3 

50 PRINT CHR$(4);"BSfiVE CONVERT, TSVS,n$2000, 120461" 
S0 PRINT CHR$(4);"L0CK CONVERT" 

For the technically curious, line 30 fixes an initiali- 
zation problem. The author of the code enabled the 
alternate character set instead of disabling it Without 
line 40, the highlighted filename flashes. If one likes 
that feature, don't bother witii line 40, ftetwell 

Wfeiterloo, Iowa 

Blazing ttie upgrade trail 

I read witii great interest your comments in the July 
OpeU'Apple (page 49) on compatibility between 
future members of the Apple II product family and 
existing products. Having spent a great deal on 
hardware and software for my system at home— so 
much, in fact tiiat the majority of Apple 11 series 
owners would probably consider it impossible, and a 
smaller but still significant amount of my employer's 
money on a system at work, 1 have given the subject a 
g'eat deal of thought 

One of tile first tilings Apple had better realize is 
that customers will make buying decisions based on 
what they peFoeli;e as best for them. While it may hurt 
our pride to admit tills, decisions on the purchase of 
personal computers, peripherals, accessories, and 
software are rarely rational. What is being purchased 
is sizzle. It is only after the purchase that one learns 
whetiier tiie sizzle was accompanied by steak. 

If potential customers perceive that Apple's product 
offerings are intended to address the company's 
needs rather than customers' needs, the products 
will not be well received. In the case of future products 
in tiie II family, tiie primary customer base has to be 
tiie millions of owners of 11 series computers. If new 
products sell well to tills audience, tiie continued 
vitality of tiie line is virtually assured, and it wiU sell to 
a wider audience. 

There is llttie doubt ttiat 3-1/2 inch disks will 
ultimately displace 5-1/4 inch disks in tiie personal 
computer marketplace. There is also littie doubt that 
Apple would like to take advantage of tiie economies 
of scale assodated with tiie use of a single type of 
disk drive in both of its product lines. There is 
undoubtedly also a line of reasoning that says tiiat if 



new computers {e.g. those based on tiie 65816 
miaoprocessor) capable of running new and mm 
poweiftil software are compatible only with a neu 
diskette standard, users of tiie existing products will 
upgrade. Ny response to tiiis is tiiat we will upgrade to 
Apple products if and only t/tiie upgrade patit oiered 
us allows us to preserve most of our existing 
investment 

In my own case, 1 do not have room for a second 
machine and all the slots in my 11-Plus are filled 
(Actually several cards are not in slots of their own, 
e.g, tiie novation Apple CAT 11 212 upgrade card is 
mounted atop tiie power supply Applied Engineering 
Z-80-Flus and Timemaster II H.O. cards share slot 7 
tiianks to a Legend Industries "Slot 8 and a Videx 
Enhancer II replaces the original keyboard encoder.) 
When software starts to become available, I would be 
very interested in acquiring a 65816 co-processor, a 
hard disk and 3-1/ 2 inch drives, but I want these to be 
in a form tiiat does not cause me to choose between 
my present equipment and a new set 

[^proposal is tiiat tiiese items be offered in a fonn 
similar to tiie ill-fated Bana 8086/2 co-processoi; 
ttdiich viffiis supp(mi to provide MS-DOS compatibility 
for tiie II-Plus and He. That product apparentiy failed 
due to a combination of poor execution at the detail 
level and under-capitalization of its manufacturer. (At 
last report, Rana was attempting to reorganize under 
Chapter 11) 

1 propose a unit that mounts atop an Apple ll-Flus 
or lie in the same manner as Apple's Duo-Disk unit It 
would interface to the Apple bus via a card tiiat would 
plug into slot 6 in place of tiie Disk 11 controller The 
unit would contain die co-processor, its ROM and 
RAM (probably up to 1 megabyte) and sockets for 
chips that could be inserted to add hard disk, floppy 
disk, and RGB video interfaces. It would be capable of 
containing (at the user's option) one or two 5-1/2 
inch floppy drives and a hard disk of at least 10 
m^byte capacity. There would be connect^s at the 
rear for a mouse, an external ke^}oard, and two Disk 
II drives. Switches or jumpers would determine 
whether on boot the system would seardi the M/4 
inch, 3-1/2 inch, or hard drive first There would be 
both input and output connectors for an riTSC 
composite video signal. A video Softswitch would 
allow switching between composite video passed 
tiirough from tiie Apple II or video generated by ttie 
65816. In all probability, at least part of the power 
supply would have to be external, as in the lie, due to 
dimensional constraints. 

If all this sounds suspiciously like a description of a 
self-contained microcomputerwith limited expansion 
capability, it is! The important tiling about it is tiiat it 
would be designed to work witii an Apple II. Those 
who wanted to use it as a stand-alone unit could 
purchase a separate keyboard and an expansion 
chassis to contain peripheral cards. These could be 
Apple 11 peripheral cards,orbonrowing(and improving 
on, one would hope) an idea from tiie IBM PC/AT they 
could be cards witii two sets of edge fingers. The first 
set would contain tiie same signals as the existing 
bus, while the second would contain additional 
signals. On tiie motiierboard, tiiese could be inserted 
into a single connector of stepped height witii tiie 
existing bus on the upper level. This would permit 
use of existing peripheral cards, \M\t also allowing 
for more advanced equipment 

My goal for the selling price of tiie basic unit witii no 
disk drives or optional chips and 256K of RAM on 
board would be $695. 

Dan Strassberg 
Arlington, Mass. 



